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SUMMARY 

The Redpark Serial Cable, which is part of the Redpark Breakout Pack for Arduino and iOS 
available from the Maker Shed , lets you connect the iPhone to Arduino without jail breaking. 
This guide shows you one of the simplest examples: connecting an iOS device to an Arduino 
and turning an LED on and off from an iOS app. 

(This guide written with lots of help from Alasdair Allan ), the author of a book on this very 
topic, iOS Sensor Apps with Arduino . 
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Connect an 


iPhone, 


iPad, or i Pod touch to Arduino with the Redpark Serial Cable 




Step 1 - 


- Wire up the RS232 adapter to the Arduino 




• Connect the RS232 adapter's 
power and ground to the Arduino's 
5V and GND pins, respectively. 

• Connect the RS232 adapter's TX to 
the Arduino's RX, and the RS232 
adapter's RX to the Arduino's TX. 



Step 2 — Make sure you're set up for iOS development 



Developer 



TeihrtOlMjies Resources PiogrArns Support Memb*rte-mef (t^Seanh Dewloptf 



iOS Developer Program 

The fastest path from code to customer 




# -• 




1. Develop 



Develop yo jr application with rh* iOS SDK 
and a wealth o1 technical resources in the 
iOS Oev Center, I ram more ► 



Test and debug, your cott on iPad, 
iPhaneartd iPDd [Ouch to finalize your 
application*. Irani more t 



3. Distribute 

Distribute yQufippS dn The App Sid r« 

and reach m llians of iPad, i Phone, and 
iPod touch Uiers, learn more > 



• To develop apps for the i Phone, 
iPad, or iPod touch, you'll need to 
register as an iOS developer. 
Although you can register for free, 
all that gets you is the development 
tools. You won't be able to deploy 
your apps to a real device. It's $99 
a year for an individual developer, 
$299 for Enterprises (this option 
lets you deploy apps directly to 
your team), and free for 
educational institutions (which also 
lets you deploy apps to a team). 

• For more information, see 
the iOS Developer Program . 
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Step 3 — Make sure you can run an app on your iOS device 




• If you've never programmed for the 
i Phone before, you can't count on 
this guide to help you. There are 
many learning resources, from 
Stanford's free Developing Apps for 
iOS courses to Matt Neuburg's 
Programming iOS 5 or Alasdair 
Allan's Learning iOS Programming , 
both of which are available in print 
or ebook form. 

• Before you go any further, please 
make sure you can create and run 
simple apps on your iPhone, iPad, 
or iPod touch. It will also be helpful 
if you familiarize yourself 
thoroughly with the Xcode 
development environment. 
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Step 4 — Create a new view-based project 



Choose a template for 


your new project: 






Frimtworit A Library 
Other 

FiMffltwOiflt £ Library 

fl0St\(MO(\ f'ui irl 

System Plug- In 

Other 


N»rt0Utof>-btt*d 

Application 


AppfitJIitHl 


B 

Spill Wew-hiicd Tib Bar Application 
Application 

Window-baifrd 

ApfritaHwi 


« 


■ 


Utility Application ffTT J^B 


| View --based Application 

This ««!;})j« provides ^ itiitiig point 'or in ippihcj! o>i itui ums i siig-le y-c*. It provides a 
viewMrttrO'ler to rranijc tht vitw, and i nib hi* that CdrtlAinj [hfcviiw. 








( Cancel ) 


Previous ( Next ) 
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Company Identifier Eom,mskeprgj«|j 

Byndl* Identifier tf?Jn-niik<;prQjecti.kelli?Ain)tiinrj- 

Dtvlw Family [ IHwwt \+4 

gfl IfWlud* LfWlit Ttili 



j Cancel } 



(_ Previous J ( He*t ) 



• In Xcode, create a new view-based project. 

• Give you project the name HelloArduino, and choose the appropriate device family 
(iPhone, iPad, or if you're feeling ambitious, Universal, though this will create a bit more 
work for you). 
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Step 5 - 


-Add 


a switch to your app 





• V t l H.lloA...t| \m] 

Run Stop Scheme Breakpoints 



_ HelloArduino- HelloArduirioViewCoritroller.xib 



i, HtlloArduino 

-2urgels_ iCE5DH4.3 

i HtlloArduino 

h HelloArcuhoAapDelcgjte h 
m HellcArdLiinaAppDele-gate.m 
■ MairtWiAdOw.xib 
h HelloArduinoViewControirer.h 
m HelloArduinoViewControHer.m 



i ^5upportirg FJci 
► f_ HellfiArdulnoTests 
► |' j Frameworks 
Products 




• On the left pane of the screen, 
expand your project, and open the 
folder HelloArduino. 

• Next, locate the 
HelloArduinoViewController.xib and 
click on it. This will bring up your 
app's main view, which is blank at 
the moment. 

• Bring up the Object Library 
(View^Utilities^Object Library), 
and drag a Switch to the center of 
your view. 

• Next, show the Attributes Inspector 
(View^Utilities^Attributes 
Inspector) and set the switch's 
State to Off. 
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Step 6 — Wire up the switch to your code 




wmm 





& 



• Now you need to tell the app's code what to do with the switch. 

• If you need room on the screen, you can hide the Utilities Pane 
(View^Utilities^Hide Utilities). 

• Next, open the Assistant Editor (View^Editor^Assistant), and locate the toolbar above 
the window that appears. 

• Click the icon to the right of the left/right arrows and make sure the Assistant Editor is set 
to automatic. It should be showing the HelloArduinoViewController.h file. 

• Control-click the switch, and drag from it to the code that appears in the Assistant Editor. 
Hold it just above the "@end" in the code and release. Add a new outlet and name it 
toggleSwitch as shown. 

• Do this once again, but instead, add a new action, and name it toggleLED. Save 
the file (File^Save). 



it 
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Step 7 — Import the Redpark Serial Cable library 






CliDose options for adding these flies: 






Destination pf Copy items into destination group's folder (if needed) 

Folders @ Create groups for any added fold tn 

Q Create folder references for any added folders 






Add to targets 3 ^ htelloAr duino 

Q 9 UelloAfduinoTesli 
















( Cancel ) fc— flntoti— ^ 





• The Redpark Serial Cable installation will create a folder in your home directory 
named Redpark Serial SDK. 

• You can download the SDK from the Redpark web site . 






Open this in the Finder, and select the inc and lib folders, then drag them to your project 
as shown. 

A dialog will appear; make sure you check the option "Copy items into destinations group's 
folder (if needed)" and click Finish. 
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Step 8 — Import the iOS Accessory Framework 




WOO 

(V) (m) [ HelloArduino I iPhone 4.3 Si 



I HelloArduino - HelloArduino. xi 



Breakpoints 



Xtode 



min 



& ■=■ m m 



& 



► Dlib 

HelloArduino 

[hj HelloArduinoAppDelegate.fi 
|mj HelloArduinoAppDelegate.m 

■. MainWindow.xib 
|li| HelloArduinoViewController.ri 
m HelloArduinoViewController.m 

H e 1 1 oAr d u i n o Vi ewControl it r.xi b 
[_j Supporting Files 

► D HelloArduinoTests 
f "| Frameworks 

Products 



^HelloArduino 



PROJ ECT 

_ HelloArdu. 



■mipriTrn 

'^■HelloArdi 



Build Phases 



Target Dependencies [0 items) 



Compile Sources {3 items) 



▼ Link Binary With Libraries <4 items) 



<~ UIKit.framework 

■5 Foundation.framework 

(^ CoreCraphics. framework 

,J NbRscMgrUniv.a 



Drag to reorder frameworks 




• Next, you need to import Apple's 
Accessory Framework. To do this, 
click the Project in the left pane, 
then choose Build Phases, and 
open the "Link Binary With" 
section. Click +, locate the 
ExternalAccessory. framework, and 
add it. 



Step 9 — Add some declarations to the view controller 



■^ ► _ HelloArduino HelloArduino • Jh" HelloArduinoViewController.h - No Selection 



@end 



// HelloArduinoViewController. h 

// HelloArduino 

// 

// Created by Brian Jepson on 7/16/11. 

// Copyright 2B11 O'Reilly Media. All rights reserved. 

// 

#import <UIKit/UIKit.h> 
#import "RscMgr.h" 

#define BUFFER_LEN 1924 

^interface HelloArduinoViewController : UlViewController <RscMgrDelegate> { 

RscMgr +rscMgr; 

UlntB rKBuffer[BUFFER_LEN] : 

UlntB txBuffer[BUFFER_LEN] ; 

UIEwitch 4toggle5witch: 
> 

^property (nonatomic, retain} IBDutlet UlSwitch +toggle5witch: 
- (IBAction)toggleLED: (id)sender; 



• Select the 
HelloArduinoViewController. h file to 
open it for editing. 

• Visit my modified version of the file 
at GitHub . 

• Edit your copy of the file: 

• Add the two lines between 

#import <UIKit/UIKit.h> 
and @interf ace 

• Modify the @interf ace line to 
match mine. 

• Add the three lines just above 

UI Switch *toggleSwitch;. 

• Save the file (File^Save). 
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Step 


10 


— Add 


some functions to the 


app delegate 



\\ < ► [^HdloArduino = [JHHelloArduino > ^ HellaArduinoViewController.m i No Selection 



// HelloArduinoViewController. m 

// HelloArduino 

// 

// Created by Brian Jepson on 7/16/11. 

// Copyright 2011 O'Reilly Media. All rights reserved. 

// 

#import "HelloArduinoViewController. h" 

@ implementation HelloArduinoViewController 
^synthesize toggle5witch; 

- (void)dealloc 
{ 

[toggleSwitch release]; 
[super dealloc] ; 
} 

- (voidJdidReceiveMemoryWarning 
{ 

// Releases the view if it doesn't have a superview. 
[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren't in use. 
} 

#pragma mark - View lifecycle 

// Implement viewDidLoad to do additional setup after loading the view, typically from a nib. 

- (void viewDidLoad 
{ 

[super viewDidLoad]; 

rscMgr = [ [RscHgr alloc] init] ; 

[rscMgr setDelegate: self] ; 



[void) viewDidUnload 



[self setToggle5witch: nil] ; 
[super viewDidUnload] ; 



A 



• Select the 
HelloArduinoViewController. m file 
to open it for editing. 

• Visit my modified version of the file 
at GitHub then edit your copy of the 
file: 

• Locate the viewDidLoad 

method and replace it with my 
version of it. 

• Be sure to Remove the 
comment delimiters 
(/* and */) before and after 
it. 

• Implement the methods required 
by the RscMgrDelegate protocol 
(add everything from my file 
from the #pragma mark - 
RscMgrDelegate methods to 
the end of the file. 

• Locate the toggieLED method 
and replace it with my version of 
it. 

• Save the file (File^Save). 
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Step 


11 


— Declare support for the serial cable 




■-V HelloArduino 

? LJ 2 targets, i05SDK4.3 

& External Accessory, framework 

HelloArduino 

[hj HelloArduinoAppDelegate.h 
[mj HelloArduinoAppDelegate.rn 

■-.' MainWindow.xib 
[hj HelloArduinoViewController.il 
[mj HelloArduinoViewController.m 
jv HelloArduinoViewControlkr.xib 
Supporting Tiles 

InfoPlist. strings 
[hj HelloArduino-Prefix.pch 
[mj main.rri 
► Q] HelloArduinoTests 
[ "1 Frameworks 
Products 



Key 






Value 


Localization native development reg 


ion 


String 


en 


Bundle display name 




String 


${PRODUCT_NAME> 


Executable file 




String 


IfEXECUTABLE_NAMEE 


Icon file 




String 




Bundle identifier 




String 


com,makeprojects.S[PRODUCT_ 


Info Dictionary version 




String 


6.0 


Bundle name 




String 


S|PRODUCT_NAME} 


Bundle OS Type code 




String 


APPL 


Bundle versions string, short 




String 


1.0 


Bundle creator OS Type code 




String 


7777 


Bundle version 




String 


1.0 


Application requires iPhone environmei 


Boolean 


YES 


Main nib hie base name 




String 


MainWindow + 


► Sjpported interface orientations 




Array 


[S items) 


▼ Sjpported external accessory protocols 


Array 


[1 item} 


Item 


oo 


String 


com. redpark, hobdb9 




A 



• This step is optional, but it 
will avoid the problem of you 
seeing an error message ("This 
accessory requires an 
application...") each time you plug 
in the cable. 

• In Xcode, expand the Supporting 
Files group and click on Hello- 
Arduino.plist to open it. 

• Right-click the bottom row, and 
choose Add Row. Click the 
up/down pointing arrows to the right 
of the new row's key (it will 
probably default to "Application 
Category") and choose "Supported 
external accessory protocols". 

• Click the triangle to the left of the 
key name you just selected to open 
up the list. In the value field for 
Item 0, type 

com. redpark .hobcib9. 

• Save the file (File^Save). 
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Step 12 — Deploy and test the Arduino sketch 



M Arduino File Edit Sketch Tools Help 



RedparkToggle | Arduino 0022 




tup() { 

Serial.begin(96Q0); // Start the s 

pinMode(13, OUTPUT); // Set the built-in LED to output mod^ 
} 

void loop() { 

if (Seri . ()) { //If there i the serial port, 

byte cmd = Serial .readQ; // read a single byte from it. 

if (cmd == '1') { // If the command is the character '1', 
digitalWrite(13, HIGH); // set the LED on 

} 

(cmd == '0') { // If the command is the character '0', 
digitalWrite(13, LOW); // set the LED off 
Serial.print(cmd, BYTE); 
} 




• Grab a copy of the sketch from 
GitHub . 

• Connect your Arduino to your 
computer. 

• Run the Arduino IDE and upload 
the RedparkToggle sketch to your 
Arduino. 

• Temporarily disconnect the jumper 
wire going to the Arduino's RX pin 
(the green cable shown in the first 
step), and upload your sketch. 

• You must disconnect it 
before uploading a sketch 
because the RS232-TTL adapter 
will otherwise interfere with the 
upload process. Leave the jumper 
wire disconnected until you 
complete the next step. 



a 
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Step 


13 


— Test the Arduino 







/dev/tty.usbserial-A700dX7K 






l| ( Send ) 






^Auloscroll No line ending j] 9600 baud C) 



• Open the Arduino's serial monitor 
(Tools^Serial Monitor), and make 
sure it's set to 9600 baud. 

• Wait a few seconds for the sketch 
to restart, then type 1 and click 
Send. The LED should come on. 
Try that again with instead of 1 , 
and the LED should go off. 

• Reconnect the jumper wire when 
you're done. 



Step 14 — Deploy the app 




• Connect your i Phone, iPad, or iPod 
touch to your Mac with a dock 
cable. 

• Make sure Xcode is configured to 
run it on the device you just 
connected (see the figure). 

• Click the Run button in Xcode. 

• If you get any errors, review 
the preceding steps to make 
sure you followed them exactly. If 
you still have problems, you can 
try downloading the project from 
GitHub. 



a 
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Step 


15 


— Run the 


app 






• The app is running on your iOS 
device, but you need to swap 
cables next, so click Stop in Xcode 
and disconnect the dock cable. 

• Plug the Redpark Serial Cable into 
your device and into the RS232 
serial adapter. 

• Locate the HelloArduino app on the 
home screen, and run it. 



If everything is working correctly, you'll be able to turn the Arduino's built-in LED on and off by 
tapping the switch button! 



This document was last generated on 201 2-1 1 -03 03:1 3:04 AM. 
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